home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / diz2153.zip / DIZ-2.DOC < prev    next >
Text File  |  1993-04-25  |  9KB  |  243 lines
  1.  
  2.                     ▀█▀▀▄  █   █▀▀▀▀▀█    ▄▀ ▄▀▀▀▀▀▄
  3.                      █   █  █      ▄▀    ▄▀   ▀   ▄▀
  4.                      █   █  █    ▄▀     ▄▀      ▄▀
  5.                      █   █  █  ▄▀    ▄ ▄▀     ▄▀   ▄
  6.                     ▄▀▄▄▄▀  ▀▄ ▀▀▀▀▀▀▀       ▀▀▀▀▀▀▀
  7.  
  8.  
  9.                                   DIZ/2 
  10.                (C)opyright 1993, written by Shawn Reimerdes
  11.                     FILE_ID.DIZ eXtractor for Prodoor
  12.                     Anti-Christ Software Designs Inc.
  13.                               $5 Shareware
  14.        
  15. ┌────────────────────────────────┐
  16. │░ Introduction ░░░░░░░░░░░░░░░░░│
  17. └────────────────────────────────┘
  18.  
  19.    DIZ/2 is a command line utility for ProDoor sysops only. It scans an 
  20.  uploaded archive for a file named "FILE_ID.DIZ" and if found, uses the text 
  21.  to replace any description typed by the user and also adds: # of files, 
  22.  oldest and newest file dates, uncompressed size. It also handles local 
  23.  uploads and will post a file with a DIZ that was intended to be private as
  24.  a private file witha DIZ.
  25.    I recommend that you use the most current versions of your achiving
  26.  utilities. If you want an achive type added in the current support, leave
  27.  me a message and I'll add it for ya.
  28.    DIZ/2 will even add the DIZ when the user didn't enter it as one of the
  29.  uploads. That takes care of the utilties like ADDBIDIR, in other words it
  30.  processes bi-directional protocols perfectly.
  31.    DIZ/2 will remove BBSAds as well. Since its already looking to see if
  32.  a DIZ is there why not check for BBSAds as well? I highly suggest using 
  33.  this feature, its surprisingly fast. If any of the ads you listed we're
  34.  found it runs pkzip to delete them.
  35.  
  36.     ■ Archivers
  37.       Supported: ZIP, ARJ, LZH, PAK.
  38.       Tested with: Pkzip v2.04x, Arj v2.x, Lharc v2.x, Pak v2.51.
  39.  
  40. ┌────────────────────────────────┐
  41. │░ Samples ░░░░░░░░░░░░░░░░░░░░░░│
  42. └────────────────────────────────┘           
  43.   
  44.  description:
  45.  
  46.      | DIZ/2 v1.50 of 4.3.93 - ProDoor utility to
  47.      | extract FILE_ID.DIZ in ZIP/ARJ/LZH/PAK files,
  48.      | adds the # of files, newest/oldest file dates
  49.      | and the uncompressed size. Local Uploading.
  50.      | Removes unwanted BBSAds, archive comment 
  51.      | generator. The fastest and most powerful
  52.      | processor out! Shareware by Shawn Reimerdes.
  53.      | Files: 10  New: 04.03.93  Old: 03.20.93 φ DIZ
  54.      | Uncompressed Size: 34,820 bytes
  55.   
  56.  
  57.  caller log:
  58.  
  59.   **************************************************************
  60.   02-25-93 (23:15) (2) JOHN SMITH (16800E) (G) NEW YORK, NY
  61.         Connect type: CONNECT 16800/ARQ/HST/HST/V42BIS          
  62.         Opened DOOR (PRODOOR) at 20:23                          
  63.         Directory Scan for (930221) ... (Ctrl-K) aborts         
  64.         DIZ/2 v1.05 of 2.25.92 by Shawn Reimerdes               
  65.         ■ Processing file: filename1.zip                         
  66.          - Files: 7 New: 02.26.93 Old: 01.21.93                   
  67.          - FILE_ID.DIZ found.                                    
  68.          √ BBSAd: (CALL.ME) removed.
  69.         1 files,  1,437k bytes,  29.8 minutes,  1709.5 cps,  118
  70.         (U) FILENAME1.ZIP Completed using G  T/E=0  CPS=1,707    
  71.         Upload Time Credit:  10 minutes                         
  72.         Pascal Conference Joined.                           
  73.         Minutes Used: 38                                        
  74.   02-25-93 (23:52) (2) JOHN SMITH Off Normally                     
  75.   **************************************************************
  76.  
  77.  
  78.  exiting errorlevels:
  79.  
  80.             29 = DIZ Found.
  81.             1  = Error.
  82.             0  = Sucessful, No DIZ found.
  83.  
  84.  
  85. ┌────────────────────────────────┐
  86. │░ How to use properly ░░░░░░░░░░│
  87. └────────────────────────────────┘
  88.  
  89.   Sample line from PROUT1.BAT:
  90.  
  91.     diz-2 diz-2.cnf %2 %PCBDRIVE%%PCBDIR%\$door.nam %PCBNODE%  
  92.                     ^           ^                      ^
  93.                     |           |                      |
  94.                   filename    path/name $door.nam     node#
  95.  
  96.   Dos command line for LOCAL uploading. If file doesn't contain FILE_ID.DIZ,
  97.   then you will be asked to enter a description.
  98.   If DIZ/2 finds a 5th parameter it assumes a local upload:
  99.  
  100.     diz-2 diz-2.cnf filename.zip $door.nam 1 c:\pcb\gen\uplddir.  
  101.                     ^             ^        ^        ^
  102.                     |             |        |        |
  103.                   filename       place holders    directory to post file
  104.  
  105.  
  106.  Note: (Check batch files included with this package)                    
  107.  
  108. ┌────────────────────────────────┐
  109. │░ Archive Comment ░░░░░░░░░░░░░░│
  110. └────────────────────────────────┘           
  111.  
  112.     If you have a registered version of DIZ/2 you will be able to create a
  113.   file that will contain variables to be translated, so that you can use
  114.   it as the comment for your archived file.
  115.     Simply create a textfile (path/name in config) any variables from the
  116.   list below will be translated and a new textfile will be created with
  117.   values in place of the %'s. After the program is done you can execute
  118.   a program to add a the newly created comment into the archive.
  119.  
  120.   variables:
  121.        
  122.        %a - archive type
  123.        %d - system date
  124.        %n - newest filedate
  125.        %o - oldest filedate
  126.        %s - size of file
  127.        %t - system time
  128.        %v - DIZ/2 version
  129.        %# - number of files
  130.        %1 - filename
  131.        %2 - FILE_ID.DIZ description (if found)
  132.        %3 - node number
  133.  
  134.   example:
  135.    
  136.    ░▒▓ Filename: %1 - %a
  137.    ░▒▓ Uploaded on %d at %t to A Clockwork Orange BBS 
  138.    ░▒▓ Files: %#  Newest: %n  Oldest: %o  Size: %s
  139.    ░▒▓ %2
  140.    ░▒▓ ■ Via DIZ/2 %v
  141.  
  142.  
  143. ┌────────────────────────────────┐
  144. │░ External Diz Plus ░░░░░░░░░░░░│
  145. └────────────────────────────────┘           
  146.   
  147.   If you want to change the look of the: | Files:  New:  Old: φ DIZ
  148.                                          | Uncompressed Size:  bytes
  149.  
  150.     Make a file as defined in the config anyway you like and use the
  151.   macros listed below to fill in the correct information. If you do
  152.   use it you should turn off the standard two lines it normally adds.
  153.  
  154.         %a - archive type
  155.         %u - uncompressed size
  156.         %i - if diz found "φ DIZ"
  157.         %d - system date
  158.         %t - system time
  159.         %# - number of files
  160.         %n - newest file date
  161.         %o - oldest file date
  162.         %v - diz/2 version number
  163.         %3 - node number
  164.  
  165.         %^ - beginning of line
  166.         %~ - end of line
  167.  
  168.  
  169.   example:
  170.  
  171.     %^│Files: %#  Newest: %n  Oldest: %o%i%~
  172.     %^│Uncompressed Size: %u  Node %3%~
  173.  
  174. ┌────────────────────────────────┐
  175. │░ DIZ-2.CNF ░░░░░░░░░░░░░░░░░░░░│
  176. └────────────────────────────────┘           
  177.  
  178.  
  179.  Example:
  180.  
  181.   Shawn Reimerdes
  182.   000000
  183.   C:\ZDIR
  184.   YES
  185.   YES
  186.   YES
  187.   C:\PCB\MAIN\CALLER
  188.   YES
  189.   C:\DIZ-2\ADS.LST
  190.   NONE
  191.   C:\DIZ-2\DIZEXTN.ALL
  192.  
  193.  -----------
  194.   Line  1 - SysOp's Name. Used to append to descriptions you upload locally.
  195.   Line  2 - Registration #.
  196.   Line  3 - Temp Directory (no trailing backslash!). For better performance
  197.             I highly recommend use of a RAM drive.
  198.   Line  4 - add "Files: X  Old: XX.XX.XX  New: XX.XX.XX" line? (YES/NO)
  199.   Line  5 - add "Uncompressed Size: X bytes" line? (YES/NO)
  200.   Line  6 - PCBoard Logging Enabled? (YES/NO)
  201.   Line  7 - Path/Name of Log. The NODE# parameter will be added to the end
  202.             of the name, for example if you entered "CALLER" the file used
  203.             would be "CALLER1".
  204.   Line  8 - Delete BBSAds from achive? 
  205.   Line  9 - Path/Name of BBSAds List that need removal.
  206.             The list should be a list of filenames. One filename per line.
  207.     
  208.             <DIZ2-ADS.LST>    FUCKBBS.AD
  209.                               -------*.*
  210.                               CALLME.*
  211.                               THEBBS.TXT
  212.  
  213.             DIZ-2 will check these filenames with the ZIP achive its checking
  214.             and if found will run PKZIP to delete them. Very Fast.
  215.  
  216.  *Line 10 - Path/Name of archive comment to be translated. NONE=off. The newly
  217.             created file will be the same name but the extension will be the
  218.             current node #. (ex: DIZ2-COM.TXT => DIZ2-COM.1)
  219.   Line 11 - Path/Name of external diz plus. NONE=off
  220.   
  221.  *=Registered feature
  222.  
  223. ┌────────────────────────────────┐
  224. │░ Author's Notes ░░░░░░░░░░░░░░░│
  225. └────────────────────────────────┘           
  226.  
  227.    I'll be releasing any new versions when time allows, if there are requests
  228.  those features will be added as soon as possible.
  229.  
  230.    I'm now asking for a small registration fee of $5, with it you will be
  231.  able to use the advanced registered features.
  232.  
  233.    If the there is an interest in this product please leave me mail on
  234.  The Tool Shop BBS or Byte Busters BBS. I'd enjoy hearing what you, the
  235.  SysOp, has to think.
  236.  
  237.    Please support Byron Forbes in his new quest for revitalizing ProDoor BBS.
  238.  Call his board and register it today and dump that CDC!
  239.   
  240.  
  241.      Thanks for your support and pass the word on,
  242.      -- Shawn Reimerdes.
  243.